home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiofile / AFinitmarkids.z / AFinitmarkids
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss((((3333ddddmmmm))))                                          aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afInitMarkIDs - specify a list of marker ID's for a new audio file in an
  10.      AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt ttttrrrraaaacccckkkkiiiidddd,,,, iiiinnnntttt mmmmaaaarrrrkkkkiiiiddddssss[[[[]]]],,,,
  16.                                       iiiinnnntttt nnnnmmmmaaaarrrrkkkkssss))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _s_e_t_u_p     is an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure, previously created by a call to
  20.                aaaaffffNNNNeeeewwwwFFFFiiiilllleeeeSSSSeeeettttuuuupppp(3dm).
  21.  
  22.      _t_r_a_c_k_i_d   is an integer which specifies an audio track in the file
  23.                configuration.
  24.  
  25.                Since all currently supported audio file formats contain
  26.                exactly one audio track, the value AAAAFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTRRRRAAAACCCCKKKK should
  27.                always be used here for now.
  28.  
  29.      _m_a_r_k_i_d_s   is an array of unique positive integer values to be used as
  30.                handles for the marker structures in a file which is opened
  31.                with _s_e_t_u_p.
  32.  
  33.                You typically allocate four marker structures so that you can
  34.                store the beginning and end points for a sustain loop and a
  35.                release loop.
  36.  
  37.      _n_m_a_r_k_s    is an integer which indicates the number of marker ID's in the
  38.                _m_a_r_k_i_d_s array.  This is the total number of marker structures
  39.                which will be allocated for the audio track.  The only
  40.                currently supported audio file formats which support marks
  41.                (AIFF-C and AIFF) may store 0 to 65535 markers per track.
  42.                Future audio formats are likely to vary.
  43.  
  44. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.      aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss(((()))) initializes a list of unique marker ID's corresponding to
  46.      the marker structures in a given audio track.
  47.  
  48.      A marker logically is a pointer to a location "between" two sample frames
  49.      in the track. You can assign sample frame positions to markers by calling
  50.      aaaaffffSSSSeeeettttMMMMaaaarrrrkkkkPPPPoooossssiiiittttiiiioooonnnn(((()))).  Position 0 is before the first sample frame,
  51.      position 1 is between the first and second, and so on.
  52.  
  53.      Markers also contain name strings.  You set the name for a marker by
  54.      calling aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee(3dm).  The string is copied into the corresponding
  55.      marker structure in the audio file header by aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  56.  
  57.      By default, the library allocates four markers in file header, which is
  58.      sufficient to store the endpoints for the sustain loop and release loop
  59.      in an AIFF-C (or AIFF) file.  You can acquire the default list of marker
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss((((3333ddddmmmm))))                                          aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      ID's by calling aaaaffffGGGGeeeettttMMMMaaaarrrrkkkkIIIIDDDDssss(((()))) after you open a new file.  The default
  75.      names for the markers are null strings.
  76.  
  77. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  78.      The Audio File Library will continue to expand the number of supported
  79.      file formats.  The ability of these file formats to store various kinds
  80.      and numbers of marks will vary.  See aaaaffffGGGGeeeettttMMMMaaaarrrrkkkkIIIIDDDDssss(3dm) for some important
  81.      notes about handling this situation.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      afNewFileSetup(3dm), afOpenFile(3dm), afGetMarkIDs(3dm),
  85.      afSetMarkPosition(3dm), afInitMarkName(3dm)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.